home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / dmedia / dmicreceive.z / dmicreceive
Encoding:
Text File  |  1998-10-20  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ddddmmmmIIIICCCC((((3333ddddmmmm))))                                                            ddddmmmmIIIICCCC((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee,,,, - transfer output from the image converter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____iiiimmmmaaaaggggeeeeccccoooonnnnvvvveeeerrrrtttt....hhhh>>>>
  13.  
  14.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee((((DDDDMMMMiiiimmmmaaaaggggeeeeccccoooonnnnvvvveeeerrrrtttteeeerrrr ccccoooonnnnvvvveeeerrrrtttteeeerrrr,,,, DDDDMMMMbbbbuuuuffffffffeeeerrrr ****ddddssssttttBBBBuuuuffffffffeeeerrrr))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee receives the next available output buffer from the image
  18.      converter.
  19.  
  20.      If it succeeds, _d_s_t_B_u_f_f_e_r will point to an output buffer that contains
  21.      the output bytes, allocated by the image converter.  After ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee
  22.      returns, the caller is automatically attached to the buffer (see
  23.      dmBuffer(3dm).  When _d_s_t_B_u_f_f_e_r is no longer referenced, ddddmmmmBBBBuuuuffffffffeeeerrrrFFFFrrrreeeeeeee must
  24.      be called to free up the buffer resource.
  25.  
  26.      The contents of _d_s_t_B_u_f_f_e_r should not be modified.
  27.  
  28.      After ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee returns, ddddmmmmIIIICCCCGGGGeeeettttSSSSrrrrccccPPPPaaaarrrraaaammmmssss, ddddmmmmIIIICCCCGGGGeeeettttDDDDssssttttPPPPaaaarrrraaaammmmssss, and
  29.      IIIICCCCGGGGeeeettttCCCCoooonnnnvvvvPPPPaaaarrrraaaammmmssss can be called to retrieve the parameters that were used
  30.      to perform the conversion. To determine whether a buffer contains an
  31.      INTRA, INTER or BETWEEN frame, use ddddmmmmBBBBuuuuffffffffeeeerrrrGGGGeeeettttIIIImmmmaaaaggggeeeeTTTTyyyyppppeeee.
  32.  
  33. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  34.      If ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee fails, and return DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE, ddddssssttttBBBBuuuuffffffffeeeerrrr is invalid and the
  35.      caller is not automatically attached to any buffer.
  36.  
  37.      ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee can fail under 2 situations:
  38.  
  39.      1. there was no buffer to receive (error code: DM_IC_Q_EMPTY)
  40.  
  41.      2. an error occured during the conversion process.
  42.  
  43.      Details of errors can be retrieved by calling ddddmmmmGGGGeeeettttEEEErrrrrrrroooorrrr((((3333ddddmmmm)))).
  44.  
  45. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  46.      dmBufferFree(3dm), dmICGetSrcParams(3dm), dmICGetDstParams(3dm),
  47.      dmICGetConvParams(3dm), dmBufferGetImageType(3dm), dmICSend(3dm),
  48.      dmICWork(3dm).
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.